home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / ftn / multis.z / multis
Encoding:
Text File  |  2002-10-03  |  7.6 KB  |  199 lines
  1.  
  2.  
  3.  
  4. mmmmuuuullllttttiiiissss((((3333GGGG))))                                                          mmmmuuuullllttttiiiissss((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      mmmmuuuullllttttiiiissss - specifies the use of the multisample buffer
  10.  
  11. FFFFOOOORRRRTTTTRRRRAAAANNNN 77777777 SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee mmmmuuuullllttttiiiissss((((bbbboooooooollll))))
  13.      llllooooggggiiiiccccaaaallll bbbboooooooollll
  14.  
  15. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  16.      _b_o_o_l
  17.  
  18.      _b_o_o_l   is either .TRUE. or .FALSE., indicating whether rendering is to
  19.             make use of the multisample buffer or not.  By default mmmmuuuullllttttiiiissss is
  20.             TRUE.
  21.  
  22. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  23.      When multisample is enabled, and multisample buffers exist in the current
  24.      framebuffer configuration in the current drawmode, rendered primitives
  25.      directly affect the samples in the multisample buffer.  Immediately after
  26.      the multisample locations at a pixel are modified, the front and/or back
  27.      framebuffer colors are written with the "average" value of the
  28.      multisample color values.  No change is made to the standard z buffer or
  29.      stencil buffer that may be associated with the color buffers, and their
  30.      contents do not affect rendering operation.
  31.  
  32.      Polygons are sampled into the multisample buffer as much as they are
  33.      sampled into the standard single-sample buffer.  A single color value is
  34.      computed for the entire pixel, regardless of the number of samples at
  35.      that pixel.  Each multisample location is then written with this color,
  36.      if and only if, it is geometrically within the exact polygon boundary.
  37.      If the Z buffer is enabled, the correct depth value at each multisample
  38.      location is computed and used to determine whether that sample should be
  39.      written or not.  If stencil is enabled, the test is performed at each
  40.      multisample location.  Framebuffer modes alpha test, blending, dithering,
  41.      and writemask affect the modification of the individual multisamples, and
  42.      have no effect on the transfer of the "average" color value to the front
  43.      or back color buffers.  Alternately, buffer enables ffffrrrroooonnnnttttbbbb, bbbbaaaacccckkkkbbbbuuuu,
  44.      lllleeeeffffttttbbbbuuuu, rrrriiiigggghhhhttttbbbb, and zzzzddddrrrraaaawwww have no effect on the modification of the
  45.      individual multisample locations; they affect only the transfer of the
  46.      "average" color value.
  47.  
  48.      Polygon pattern and line style pattern bits apply equally to all
  49.      multisample locations at a pixel.  All sample locations are considered
  50.      for modification if the pattern bit is one.  None are considered if the
  51.      pattern bit is zero.
  52.  
  53.      Lines are sampled into the multisample buffer as rectangles centered
  54.      around the exact zero-area segment.  The rectangle width is equal to the
  55.      current linewidth. Its length is exactly equal to the length of the
  56.      segment.  The rectangles of colinear, abutting line segments abut
  57.      exactly, so no multisamples are missed or drawn twice near the shared
  58.      vertex.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. mmmmuuuullllttttiiiissss((((3333GGGG))))                                                          mmmmuuuullllttttiiiissss((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      Points are sampled into the multisample buffer as circles centered around
  75.      the exact point location.  The circle diameter is equal to the current
  76.      pointsize.
  77.  
  78.      Polysmooth, linesmooth, and pointsmooth, must be disabled while
  79.      multisample is enabled, or rendering results are undefined.
  80.  
  81.      Text is sampled into the multisample buffer by converting each '1' in the
  82.      character mask into a 1x1 square, which is then sampled just like a
  83.      polygon.
  84.  
  85.      During pixel operations either all multisample locations at a pixel are
  86.      sampled or all are not.
  87.  
  88.      There are no special clear commands for the multisample buffer.  Rather,
  89.      the standard cccclllleeeeaaaarrrr, zzzzcccclllleeeeaaaarrrr, sssscccclllleeeeaaaarrrr, and cccczzzzcccclllleeeeaaaa commands affect the
  90.      multisample buffer as much as they affect the standard color, stencil,
  91.      and z buffers.  Clear modifies the enabled color buffers, and always
  92.      modifies the color portion of each multisample location.  zzzzcccclllleeeeaaaarrrr operates
  93.      on all multisample z locations.  sssscccclllleeeeaaaarrrr operates on all multisample
  94.      stencil locations.  cccczzzzcccclllleeeeaaaa behaves like cccclllleeeeaaaarrrr and zzzzcccclllleeeeaaaarrrr, except that the
  95.      z value is specified.
  96.  
  97.      When multisample is disabled, but the system is configured for
  98.      multisample operation, rendering neither affects the multisample buffer,
  99.      nor is it a function of the contents of the multisample buffer.  It is as
  100.      though there were no multisample buffer at all.  zbuffer, if configured
  101.      and enabled, tests and updates the standard z buffer, not the zbuffer
  102.      locations in the multisample buffer.  Likewise stencil, if configured and
  103.      enabled, tests and updates the standard stencil buffer, not the stencil
  104.      locations in the multisample buffer.
  105.  
  106.      Polysmooth, linesmooth, and pointsmooth are well defined when multisample
  107.      is false.
  108.  
  109.      Multisample state is maintained but ignored if no multisample buffer is
  110.      configured.  Because it is not possible to allocate a multisample buffer
  111.      in color index mode, mmmmuuuullllttttiiiissssaaaammmmpppplllleeee is always ignored in color index mode.
  112.  
  113.      The multisample buffer is a part of the normal framebuffer.  multisample
  114.      should be called only while drawmode is NNNNOOOORRRRMMMMAAAALLLL, and it affects rendering
  115.      only while drawmode is NNNNOOOORRRRMMMMAAAALLLL.
  116.  
  117. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  118.      msalph, msmask, mspatt, mssize
  119.  
  120. BBBBUUUUGGGGSSSS
  121.      On the IRIS-4D RealityEngine model the values of frontbuffer, backbuffer,
  122.      leftbuffer, and rightbuffer should not be changed between the time cccclllleeeeaaaarrrr
  123.      or cccczzzzcccclllleeeeaaaa are called and the time that the rendered image is complete.
  124.      At least one of the color buffers must be enabled during all use of the
  125.      multisample buffer.
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. mmmmuuuullllttttiiiissss((((3333GGGG))))                                                          mmmmuuuullllttttiiiissss((((3333GGGG))))
  137.  
  138.  
  139.  
  140.      Points are in fact sampled into the multisample buffer as squares where
  141.      the squre width is equal to the current pointsize.  This will be fixed in
  142.      a future release.
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.